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ABSTRACT 

This report is for design programmers, developers, coders, and programming technical 
writers. The focus is on producing method of operation diagrams that picture the internal 
functions of a programming system. 

The main objective is to improve communication procedures and techniques through the 
effective use of functional operation diagrams. 

The report describes how to produce operation diagrams that depict the internal functions 
of a program system or subsystem. Instructions are given on how to produce single diagrams or 
sets of diagrams that convey functional information efficiently. 

A single method called HIPO (Hierarchy plus Input — Process — Output) is stressed for two 
reasons: 

1. The method is a natural reflection of the development and implementation process 
and will be relatively easy to master. 

2. HIPO is a common base, or graphic language, through which we can understand 
one another. 

Some of the diagramming techniques presented herein will find natural applications in the 
daily traffic of technical correspondence among all IBM personnel. 



IBM Confidential 

This document contains information of a proprietary nature. ALL INFORMATION CONTAINED HEREIN SHALL 
BE KEPT IN CONFIDENCE. None of this information shall be divulged to persons other than: IBM employees au- 
thorized by the nature of their duties to receive such information, or individuals or organizations authorized by 
the Systems Development Division in accordance with existing policy regarding release of company information. 



IBM 



poughkeepsie lab 

Systems Development Division 



IBM Confidential 



TABLE OF CONTENTS 

Page 

INTRODUCTION 1 

WHAT HIPO IS 1 

THE GROUP PLAN 1 

VISUAL TABLES OF CONTENTS 1 

THE FUNCTIONAL PACKAGE 2 

THE VALUE OF HIPO 4 

LARGE SYSTEM DOCUMENTATION 4 

FUNCTIONAL DOCUMENTATION 4 

EDUCATION 5 

OTHER FEATURES 7 

DOING HIPO DIAGRAMS — THE STEPS 8 

DEFINING THE OBJECTIVES OF THE DIAGRAMS 8 

PLANNING THE STRUCTURE OF THE DIAGRAMS 18 

EXECUTE 22 

ACKNOWLEDGEMENT 29 

APPENDIX A: OPERATION DIAGRAMS — DIALOG 31 

APPENDIX B: A GROUP PLAN 40 

APPENDIX C: A HIPO PACKAGE 43 

APPENDIX D: OTHER PROGRAMMER-GENERATED HIPO DIAGRAMS 53 

APPENDIX E: WRITER-GENERATED HIPO DIAGRAMS 58 



in 



BM Confidential 



INTRODUCTION 



Since the beginning of "software", the programming community has thought of software 
products as being largely invisible, and having no recordable, functional structures. We have 
learned to think and to document in terms of the code only, rather than of the functions we 
support with the code. 

So when the system is subsequently modified, we relegate ourselves to working in the dark. 
At each release we spend much time working with the pieces to get an idea of the whole. And 
we pay the price in terms of hidden interfaces, integration problems, and slipped schedules. 

It does not have to be this way. Functional program structures can be graphically 
recorded in much the same way as building structures are recorded in blueprints. 



WHAT HIPO IS 

HIPO, Hierarchy plus Input — Process — Output, is a method of graphically describing 
internal function by structuring a presentation from general to detailed levels in a set of 
method of operation diagrams. A HIPO presentation consists of: 

• A group plan. 

• Any number of functional packages (determined by the group plan). 

o Visual tables of contents to each of the functional packages or, later 
in the effort, a single table of contents to the entire presentation. 

THE GROUP PLAN 

Initial work is done at the project planning stage to develop a plan that specifies the 
major functional breakouts for the project. It is important to do a group plan before 
beginning the individual packages to help prevent subsequent duplication of effort on the parts 
of the programmers or writers doing the packages. 

An example of a group plan calling for five functional packages is shown in Appendix B. 

VISUAL TABLES OF CONTENTS 

A visual table of contents is prepared for each of the packages. It shows: 

• The structural relationships of the diagrams within the package. 

• The contents of each of the diagrams. 

• A legend applying both to the individual package and the total presentation. 
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Visual tables of contents appear as the first diagrams in Appendixes C and D. 
Note: After all packages are firm, their individual tables of contents can be replaced by a 
single, comprehensive visual table of contents if the size of the total presentation is small 
enough that a single contents page is practical. 

A FUNCTIONAL PACKAGE 

Each of the packages contains a visual table of contents, one or more overviews, and a 
number of low level diagrams showing the implementation and/or design of a function. 

The number of levels in a package is determined by the number of "functional subassemblies", 
the complexity of the material, and the amount of information to be documented. Although 
there are no theoretical limits to the number of levels of detail, a practical limit is five levels, 
including the overview. Beyond this, the package will become difficult to refer to for 
information. Usually a package will result in three or, infrequently, four levels of diagrams. 

The overview, or upper level, diagrams act as introductions to the functions and directors 
to the low level, detailed diagrams. 
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DIAGRAM 1: SYSTEM OVERVIEW 
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The low level diagrams contain "unit level" information (that level of information 
reflecting the actual workings of the system). Each low level diagram is arranged to best show: 

• A process that supports the function being described. 

• Results of the process. 

• Requirements for processing. 



Stated graphically: 




The information in a low level diagram changes from time to time in the development 
cycle; that is, during early design phases, the unit level deals with basic design plans. 
During the implementation phase, this information consists of basic implementation points (how 
the design points have been implemented). This is discussed in more detail under "Define 
the Objectives of the Diagrams." 

A typical functional package appears in Appendix C. Examples of low level diagrams are 
included in Appendixes C, D, and E. (Appendixes C and D show diagrams done in the design 
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phase; Appendix E shows diagrams that reflect functional points and the implementation of 
those points.) 

THE VALUE OF HIPO 

In discussing the value of HIPO, it is necessary to discuss a few of our major communication 
problems: 

• We document large systems as though they were small ones. 

• We don't document function soon enough. 

e We spend inordinate amounts of time on informal education during the development 
process. 

LARGE SYSTEM DOCUMENTATION 

As systems get larger, a time comes when restructuring becomes necessary. A point is 
reached where systems, "done" in the old way, become inefficient because of their very sizes 
or degrees of complexity. 

Methods of communication are not exceptions to this rule; as the amounts of information 
increase, systems must be described in terms of more comprehensive subsystems and higher level 
concepts so that the users of those systems can be better equipped to get to the points of their 
problems quickly. 

Unfortunately, the descriptions of our programming systems have not advanced with 
increased system complexities, sizes, and technological breakthroughs in the software area. 
Our documentation methods are sometimes tantamount to describing computer hardware solely 
in terms of electronic circuit components. 

This is not to say that unit level information is unnecessary. After all, it is the unit level 
information that reflects the true workings of the system. And it is this information that we 
must, in the end, use to solve our problems. But we have cast ourselves in the roles of low- 
level part makers, each describing how his part makes the total system go. 

HIPO eases this problem in the area of internal function by providing a hierarchial frame- 
work under which the higher level functions can be pictured. Relationships similar to the 
country — state — city map structures are established to help the user get quickly to the point of 
his problem. 

FUNCTIONAL DOCUMENTATION 

In the development effort, we neglect program logic throughout the late stages of the cycle 
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and instead concern ourselves primarily with producing massive amounts of code-oriented 
information with little or no good pictures of how things really tie together. 

At the end of the cycle, an attempt is made to "rediscover" function by analyzing listings 
and reading various specification material that was generated earlier in the cycle. But this 
process is very difficult to do because: 

• During implementation, functions become intermixed with other functional structures 
in the code. 

Three major functions — before implementation. 
THREE MAJOR FUNCTIONS- BEFORE IMPLEMENTATION. 
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• Furthermore, as a project moves through the development cycle, our thinking becomes 
implementation-oriented, and less oriented toward the logic behind what is being done, 
Thus, late in the cycle, we speak more of routine organizations and the code-oriented 
jobs we are doing rather than of logic. 
So the task of rediscovering function late in the cycle (or at the beginning of the next 
release) is made very difficult. 

The HIPO approach solves the problem of vanishing functional logic by providing a 
framework for establishing and documenting these functional structures early in the cycle and 
then developing the documentation concurrent with the design and implementation of the 
function. As an added benefit, HIPO will act as a tool to assist the designer/developer in 
thinking his way through the project and in uncovering logic errors early in the design stage. 
The following diagram shows how, ideally, basic functional information can be produced 
early and then developed through the cycle. 

EDUCATION 

As we move from release to release, the system base is altered to accommodate new or 
changed functions. In modifying the base, the delta (design change) programmers have 
PLM's, listings, and (sometimes) base module owners available for the education process. 
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The PLMs are not currently suitable for helping the programmers come to a quick understand- 
ing of the base. And the module owners, if available, have problems of their own. So this 
leaves the listings, which are at a low level of detail. 

In using the listings, the delta programmer is forced to work with large amounts of detailed 
information in order to reconstruct the base logic to the point where he can understand all of 
the areas that will be affected by his design. Only after the programmer is familiar with the 
base can he begin serious work on the new functional design. 

This problem is compounded by the fact that in a given release there can very well be more 
than one function affecting the same base. Furthermore, the designers of the different functions 
might be geographically separated. 

HIPO can ease some of the education and communication problems by providing a framework 
for a common, visible base in the form of a structured set of diagrams. Education time will be 
lessened because the programmer can familiarize himself first at the general levels and then at 
the lower levels, as applicable. 

Integration problems and adverse impact with other programming groups will be easier to 
check earlier because the different groups can mark their delta changes on copies of the same 
set of base diagrams. 

OTHER FEATURES 

Making the programming functional structures visible should cause marked improvements in 
many areas . Look for: 

Better control over the design, development, and implementation of a system: 

1. In clearer definitions of the points of functional interfaces, resulting in 
better functional monitoring capabilities. 

2. In smoother information transfers and less duplication of effort throughout the 
development cycle. 

3. In better definition of design versus implementation tasks. In apportionment 
of assignments at the group level. 

4. In functional testing. 

5. In compressed cycles at n+1 (next release) time. Quicker retrievability of 
information and faster fixes in the laboratory maintenance environment and in 
the field. 

6. In lessening the impact of the loss of a lead programmer. 
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DOING HIPO DIAGRAMS— THE STEPS 

1. Define the objectives of the diagrams. 

2. Do the group and package plans. 

3. Execute the individual packages of diagrams. 

DEFINING THE OBJECTIVES OF THE DIAGRAMS 
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The ultimate worth of the HIPO presentation will far exceed the time and costs incurred in 
preparing the diagrams if time is first taken to define and understand what information should 
be included in the package. Making these definitions will eliminate many problems that would 
otherwise be experienced in producing a successful set of diagrams. 

The Needs of the Users 

The diagrams should be developed in parallel with the design and development effort, as 
discussed under "Functional Documentation" in the preceding section. Users will differ through- 
out the cycle; however, diagrams can be produced to serve the common needs of a great many 
users . 

Here are some of the uses to which diagrams might be put: 

EDUCATIONAL AID — Development laboratory and field personnel will use the 

diagrams to familiarize themselves with internal function. 
DESIGN AND DEVELOPMENT AID— You, as the designer, developer, or writer 
become a user of your own diagrams. The act of doing the 
diagrams assists your thought processes. In addition, you will 
be able to quickly retrieve information that you have recorded 
in the diagrams. 
MONITORING AID — The diagrams will provide an excellent facility for keeping track 
of the design and implementation of function. 

MANAGEMENT AID — The diagrams might prove useful in making more accurate 

estimates of the amount of work involved in a project and in a 
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better distribution of resources. 

TESTING AND INTEGRATION AID— The diagrams will prove useful both to 
product test and to in-house test groups in determining 
what functions need to be tested. The diagrams will prove 
quite valuable for the integration process. 

DIAGNOSTIC AID — The diagrams will be used to help diagnose problems and 

hasten fixes, both in the laboratory maintenance environment 
and in the field. 

OTHER — Other uses will be found for the diagrams. For example, the Software 
Monitoring Technology group in Poughkeepsie feels that the 
diagrams might prove valuable for projecting performance 
estimates earlier in the cycle, tracking performance as the 
product is developed, and aiding in the area of developing 
functional models. 

The Relation of the Diagrams to Other Documentation 

Unless the creator of a diagram package is fully aware of other types of information 
provided outside of the package, he will probably include items from these areas within his 
diagrams. This is wrong for the following reasons: 

a The diagrams will not work the same way that diagrams prepared by someone else 
do because each person will have a different idea of the informational needs of the 
diagrams. 

• The diagrams will be subject to change from each of the non-functional areas that are 
included. 

• Duplication of effort will result and redundant documentation will be generated. 

• Users will have trouble locating information quickly because they will never be sure 
of where to look for specific kinds of information. 

Functional Versus Program Organization Material: Under current technologies, the single most 
important relationship is that between functional material and program organization material. 
The differences are touched on here; a full explanation is provided in the publication 
PLM Guidelines manual, Form Z28-6673-I. 

There is usually a certain amount of confusion as to what program organization and method 
of operation are, and how they relate to one another. The main reason that the distinction, and 
the resulting separation of material, is made is because in a large system: 
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• A specific module might support 

parts of many functions. Sometimes 
these functions are not even related. 
Someone who must modify an existing function, add a new function, test for regression, or 
fix the system must know: 

1. How the function is performed. 

2. What other, perhaps non-related, functions use the same code. 

I, above, is one of the basic objectives of method of operation diagrams — to show 
functional logic and to show how the activation of function ties in with the code. 

2 is one of the objectives of program organization — to show the code structures pertaining 
to the combined functions. 

To tie together the program organization and functional areas, PLMs use cross references 
from one area to another and to the listings. 
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LISTINGS 

Content of the Diagrams 

Content can be discussed in terms of the information to be conveyed (informational content) 
and the graphic means used to express the subject (graphic content). 

Graphic Content: The graphic content is determined by the situations to be depicted. Some 



-10- 



BM Confidential 



typical situations and suggested graphic applications are 
STARTING POINT - A heavy black 



arrow can be used to lead the 
reader into the diagram at the 
proper point. 

DATA MOVE - An open arrow 
shows movement of data into 
a temporary work area or 
initialization of a data area. 
The open arrow is also used 
to show the availability of 
input to a processing step 

DATA ALTER - A hatched 
arrow shows movement of 
data into an area that has 
previously been initialized 
or otherwise used. 

FLOW OF ACTION - Black 
arrows used with numbered 
processing steps show flow 
of action through the process. 



OUTPUTS 



SUBPROCESSES - Boxes and titles 
are used to group related processing 
steps. Shading is optional. (See 
Appendix E for examples of titled 
subprocess blocks.) 

DATA AREAS: PARAMETER LISTS 
Boxes are used to represent data 
areas and parameter lists. Light 
arrows are used to show pointer 
arrangements, where applicable. 
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REFERENCE INDICATOR - 
A dotted arrow means 
" — refer to this item." 
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BLOW-UPS - Blow-ups can 
be used to expand on areas 
shown in the context of 
larger data areas. (See 
any of the low-level 
diagrams in Appendix C 
for examples of blow-ups.) 
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KEYS - Keys establish relationships; 
identify blow-ups; lead to other 
diagrams. 

Delta symbol is used to indicate a change to a base diagram. The 
symbol should either identify a corresponding delta diagram that shows 
the actual change or it should indicate the nature of the change. 
Examples: 






On page connectors can be used a directional keys. The connectors 
should be used with appropriate arrow types to show data movement, 
modification, or flow of action. Note that the connectors should 
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a 




always point in one direction (from — to), never toward one 
\y-~ ^v another. The directional key is useful wherever crossing lines 

\~\J would otherwise have to be used. For example, instead of this: 
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Off page connectors are used to lead to related diagrams, as in 
flowcharts. 



-13- 



BM Confidential 



Informational Content: Functional diagrams should discuss inputs, process, and results. For 
the sake of clarity, these elements should be presented in a normal reading sequence. Simple 
boxes can be used to block off these three major areas of the diagram. 

The "picture area" of the diagrams should contain as few words as possible. There are two 
reasons for this: 

• When the picture becomes cluttered with text, it will lose some value as a 
recall mechanism. 

• The degree of difficulty of maintaining the diagrams increases with increased number 
of words in the picture area. (Also, it is more time consuming and costly to automate 
diagrams having many words in the picture area.) 

So expand upon the basic points by including extended descriptions away from the primary picture 
area. Perhaps you might even want to include the descriptions on a separate piece of paper. 

The following sample diagram shows how to simplify the picture area by condensing what has 
to be stated into a few useful words. This is similar to the newspaper technique of summarizing 
the paragraph before presenting the details. 
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Step 3, in the previous diagram, is one of the steps showing what has to be done to support 
the overall function (COMPRESS). The brief caption, "Format data", can be compared to a 
paragraph title. 

The content of the extended description (not shown in the above diagram) that supports 
step 3 depends on when in the development cycle the diagrams are to be used. The extended 
descriptions and the type of information to be included are shown in the following diagram. 
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At initial design time, this will be gross design thoughts 
relating to the corresponding design points in the diagram area 

When design is complete, the extended description will have 
been converted to detailed design descriptions. 

When the PLM material is prepared, this information will be 
converted from "what" to "how". That is, these steps will 
be converted to basic implementation steps that support the 
function. Pointers into the listings will be established to lead 
the user from function to implementation. (See Appendix E) 
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In the PLMs, functions will be related by cross-references to the module(s) supporting those 
functions. The addition of cross-references creates a "functional mapping" through the 
implementation. 

Implementation steps 1 and 2 are performed 
in ROUT1 . Step 1 can be picked up at key 
label START in the listings (also found on 
flowchart AA) . 

Step 2 can be picked up beginning with key 
label BUILD (found on flowchart AB). 

Prior to step 3, a passing of control is im- 
plied by the horizontal line through the 
routine column. Steps 3 and 4 are performed 
in routine ROUT2. 
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To summarize graphic and informational content: 
Graphic content 



Boxes used to 

• Localize inputs, process, outputs. 

• Represent data areas, fables, fields, etc. 

• Isolate related sub-processes within the processing 
area (reinforced by shading). 

• localize extended descriptions. 




Arrows used to 

Get the reader into the diagram . 
Lead the reader through the process. 
Act as pointers. ^ ■ ^ 

Call the reader's attention to clarifications, blow ups, before- 
after drawings, etc.~"*~* 
Show data flow, 
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Other Symbols Q ■ ^7 fl Q^ Q /\ 

• Used as keys to connect secondary descriptions, explanations, related 

material, blowups, etc. 
e Used to identify points on master diagrams where changes are applicable, 

o Used in conjunction with any of the arrow line weights where crossed lines 

would be confusing. 



Informational Content 
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results. 


(in the form of routine names, 
key labels, and flowchart 
IDS) to the listings, flow- 






charts, and routine descriptions. 
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PLANNING THE STRUCTURE OF THE DIAGRAMS 



PLAN 
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After all concerned have a good understanding of the purpose and content of functional 
diagrams, work can begin on the group and package plans for the project. 

Plan at the Group Level 

A plan should be prepared at the group level to determine what functional packages will be 
needed. The individual programmers, using the plan as a point of departure, can then plan and 
execute the specified packages of diagrams. 

The group plan should be represented in the same form as a visual table of contents. It 
should specify the individual packages, describe the legend to be used, and note any other 
conditions, such as responsible parties, peculiar to the project. In some cases, a very high level 
diagram can be prepared to show how the packages relate to one another. (See Appendix B for 
an example of a group plan.) 

Who will use the plan? 

• Management — to establish checkpoints for examining and controlling workloads 
and resultant development. 

• The designer/developer — as a departure point from which he will prepare the 
functional packages. 

• The writer — to ensure that all areas are adequately documented at release time. 

Plan at the Individual Level 

Each of the departure points documented in the group plan will become an overview diagram 
for an area of functional responsibility. Before the overview diagram is prepared, however, the 
package should be analyzed for logical breakouts into smaller, more controllable areas. This 
will result in a top down plan (and visual table of contents) for the packages. (See the first 
diagram in Appendix C for an example of a top down plan.) 
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In preparing the top down plan, determine the major areas that will have to be covered, 
Represent these areas individually as the next level of diagrams under your overview. 




Then analyze each of these major areas, in turn, to determine the necessary scope of 
coverage at lower levels. 



E 
F 
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Continue this process until the total scope of the package has been determined, 
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M 



-19- 



BM Confidential 



Note in the previous diagram (C, H, L and M) that you need not carry all breakouts to the 
same level. The breakouts are determined, to a great degree, by the complexity and amount of 
material to be covered. 

Planning from top to bottom will provide the following benefits: 

• You will think through the requirements of your project systematically. This is 
similar to preparing a topical outline for a presentation or book. Doing the top 
down plan will help you define the true size of the project. 

e You will be better able to estimate the amount of necessary coding because you 
will have available a diagram plan that parallels the functions to be supported. 
Your estimates will be more accurate because you will be working to small, 
controllable scopes. 

• When you begin execution of the package, you will have fewer false starts. The 
diagram package will be less subject to change because of poor organization. 

• You will not inadvertently "inflate" the relative importance of given functions. 

• Points of functional interface will be preserved for the next release. At that 
time, you will not have to rediscover the same structures you are now developing. 

Special note: If you are attempting to diagram function that has already been coded, the 
problems in planning the top down package will be compounded. In these cases it will help 
to do the following: 

1 . First draw a program organization hierarchy chart (or refer to one if one exists). Show 
the possible calling sequences of the involved routines. This can be done conveniently 
in either of the two following ways: 
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B 
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H 



Each of the legs probably reflects the Implementation of a function or series of functions. 
For example: 



Sequence through routines ABCD 

ABE 
AFGC 
AFH 



= Function 1 . 
= Function 2. 
- Function 3. 
= Function 4. 
ACDEG = Function 5. 
ACH = Function 6. 
2. The next step is to analyze the program organization hierarchy charts and the listings 
to begin your top down plan. In developing the plan, first determine what the major 
functional variations are. You will be able to combine many of the minor variations 
within the scope of a single chart. The previous example of program hierarchy might 
result in the following top down plan: 



OVERVIEW OF 

• FUNCTIONS 1 AND 2 

• FUNCTIONS 3 AND 4 

• FUNCTIONS 5 AND 6 



DETAIL FOR 






FUNCTIONS 
1 AND 2 



FUNCTIONS 
3 AND 4 



FUNCTIONS 
5 AND 6 
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You know what the purpose of the diagrams is. You know what the graphic and informational 
content should be. What remains is to sit down and begin the diagrams. 

How do you start? 

Localize 

Divide the paper into three areas: 



S: INPUTS 

WILL 
|:&:: GO 
Mi HERE 



Later, after you have worked out some of the 
..::..■•■ i. ....•;; general considerations, you might want to 

further subdivide to provide an area for blow 
ups, before/after pictures, tables, or extended 
descriptions to the processing points. 



PROCESS 

WILL 
GO HERE 



RESULTS 
WILL 
HERE 



Remember that initially you are dealing with function. Not with routines. 
Begin by drawing a large open ended box in the center of the paper. 
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Work from results to process, and vice versa, jotting down the points as you think of them. 
Keep the processing points similar in detail to paragraph titles. You can expand on them later. 




As you do this, input requirements will make themselves known. Jot these down on the left 
side of the paper and connect them to the processing steps to which they apply. 



t-4 



£ 



The time you are now spending on "drawing" is not really drawing time — it is thinking 
time. The drawing will evolve as a by-product of your thought processes. Rather then being 
extra work, this process is actually a tool to help develop the product. 

Localizing the inputs, process, and outputs is better than using the standard flowchart 
approach to show function because inputs and outputs are not readily indentifiable in flowcharts. 
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One additional method can be used to help localize diagram components; this is shading. 
Although not a requirement of the HIPO technique, shading can add a great deal in making 
diagrams more understandable. 



Use shading as a foil for: 

• major process groups. 

• inputs. 

• results. 




1=31 



tZZJ 



Use the side of a number 2 pencil to apply shading to your final drawings. 

Minimize Exposures Due to Changes in Logic 

There are a few simple considerations that will help you minimize the number and degree of 
changes to the diagrams. 

1. Show only those fields of data with which the function is concerned. Treat the rest as 
a black box. Do not include displacements. 
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DRT 



KEYWORD PROCESSING 
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KEYWORD COUNT 

£> ( I CHECK NO. OF 

KEYWORDS 



KEYWORD TYPE 



DETERMINE 
TYPE 



When dealing with data areas belonging to another area of responsibility, use terminology 
consistently. In addition to eliminating some of the confusion over terminology in the 
field, this might help you think along the same path that the originator did. 

Note: In documenting outputs, always try to state "who" will use what set up. Similarly, 
if in a subsequent release you use an external data area that you didn't use before, 
notify the "owner". Someone will have to update the "outputs" portion of that chart. 
2. Find common denominators at the higher levels. 
Example: In an overview diagram — 

Instead of describing the action for each keyword in the overview, describe in terms of 
general keyword processing. This way, if you subsequently document a new keyword, 
you can add it to the package at a lower level without seriously impacting the overview 
diagram. This ensures that the package is as modular as is possible. 
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Ideally, a function entering the system at T, below, should not impact Z, 



3. Use cross-references from one level of chart to another (vertical references) and from 
one chart to another at the same level (lateral references) to confine possible changes 
to as few charts as possible. The cross-references will also help to tie the charts 
together. 
Example: 
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Be Consistent 

Consistency is one of the more important keys to good communication. If you handle similar 
problems in similar manners throughout the package, the reader will be able to understand the 
informational content of the diagrams without having to fight the graphic symbology or structure 
of the diagram. 

• Remember to localize 

• Use a standard symbology and stick to it. If you devise a unique graphic symbol to 
explain something, you are probably defining a language that only you can understand. 
In these cases, use text instead. 

o Don't change your style in the middle of the package. 

File Your Structure 

It is quite important to file the structure for subsequent quick access. 

1 . Use the top down plan . 

Your top down plan does not lose its usefulness after you have planned your project. The 

plan can be used as a visual table of contents to the diagram package. 



LEGEND 



oo 

A 



12 



CONTENTS 



I I 



IDENTIFY EACH DIAGRAM 
BY GENERAL CONTENT 
AND DIAGRAM NUMBER 



The table of contents page should show a legend, the structure of the following diagram 
package, and a summary of the contents of each of the diagrams. With this visual contents 
page, the reader is not forced to read the diagrams sequential; that is, he can locate a 
particular level of information or a specific diagram without thumbing through the entire 
package. 
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2. Reference from diagram to diagram 

High level diagrams should lead the way to the lower level diagrams. Perhaps the best way 
to do this is to use the off page connector (see Appendix D for examples of this). 

Middle level diagrams should refer both up and down to maintain the chain of references. 

3. Information retrieval 

Another type of filing that will be necessary is that of recording the identification of those 
diagrams that are affected by design changes. It will be necessary to establish a means of 
control over retrieving and updating diagrams from release to release. 

Use Existing Tools 

As was pointed out under "Localize", the time to do initial drawings should not be thought 
of as drawing time, but rather as thinking time. Jotting down your thoughts in a systematic way 
will help formalize them. 

1 . Template and grid 

But there comes a time when you will want to make, or have someone else make, a better 

copy of your diagrams. Currently there are two tools that will help you do neat, uncluttered 

diagrams with a minimum of fuss. These are: 

• the Program Logic Template and Jacket (Form Nos. zx28-6734-0 and zx28-6735-0) . 

• the drawing grid — 18" by 24" vellum on which a one inch, non-reproducible blue grid 
has been printed (Form No. zx28-6736-0 — 1 pad of 25 sheets). 

Using these tools, writers have been able to realize a savings of from $17 to $40 per diagram 
(over previous vendor costs) in producing draft copy for final preparation of art. 

Furthermore, there is no need to take time to measure or rule the drawing; the grid and 
template do this automatically. 

All of the diagrams in the Appendixes were prepared using the template and grid. As an example 
of the speed with which final drawings can be done: 

The nine diagrams in Appendix C, done by a design programmer, were done in A\ hours. The 
programmer had no prior experience with formalized drawings. 
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TEMPLATE AND GRID PAPER 
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APPENDIX A 



OPERATION DIAGRAMS ~ DIALOG 

The appendixes are divided into two parts. First is an interview conducted by the author, 
Tom Wolfe, with a group of programmers who created method of operation diagrams during the 
design phase of their project. The programmers involved are: Pete Bowen, Barbara Butler, 
Donna Dethoff, Terry Elliott, Dave Fish lock, and Sue Montano. 

These people were among the first programmers to document design with method of operation 
diagrams. 

The second half is samples of their diagrams. 



Note: All examples in these appendixes are photographs of actual pencil drawings done by 
programmers and, in Appendix E, by the writer. 

A second report is being prepared by the OAK programmers. The report will deal with 
the benefits and problems of diagram packages as seen by the parties involved in the 
OAK effort. 

The appendixes included herein do not necessarily reflect all of the points made in the 
front section of this report. 
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Tom: How many diagrams were in the packages that you prepared? 

Pete: I did eighteen large charts and four foil charts. The foils were drawn on 8£" x 1 1 " 
pieces of paper and were not duplicated on the large charts. These were general 
functional charts; general enough so that they would fit on a small piece of paper like 
that. 

Sue: I did nine diagrams including the overview. I did the drawings in two phases, first 

initial roughs, and then the full set. I should probably mention that when I began, the 
design was already quite firm. There were only a few areas that I had to change. For 
those first drawings, I probably drew the whole set in about 2 hours at the most; but 
they weren't really that detailed. For the second set, the detailed charts, I had to 
make all the little decisions — what's this bit going to be, what am I going to call 
this field and that — so it took me a little longer, especially planning out the format 
of the diagrams. First I sketched what I wanted on a piece of scrap paper. That probably 
took me about ten minutes. Then it took me a good half hour to do each of the detailed 
diagrams. That would be about A\ hours for actual drawing time. 

Donna: I did five diagrams myself. I did one chart that showed what my other charts were going 
to be. Then I did four charts which were a breakdown of four particular areas I was 
working on. 

Tom: This next question is in two parts. First of all, did you enjoy doing the diagrams, and 

then do you think that they help you think through your project? 
Sue: I guess I can answer yes to both of those questions. I did enjoy doing the diagrams 

because I like to do detailed work. I definitely think that they help you think through 

the project. 
Donna: I'd say yes to both questions. It was enjoyable working with diagrams rather than trying 

to write out what I was doing. Any by doing the diagrams, I had to think what the next 

step would be and put it down concisely; I think this helped my thinking and also my 

design. 
Sue: Before starting the charts I had most of the major concepts already planned out, but when 

it came down to the bits and bytes the diagrams made me get my ideas down concretely. 

Tom: Well, then would you think that the diagrams are a good way to show function? Are 

they better than text or flowcharts? 
Barbara: Yes. As you know, I was a tester on this project and not a developer. In the past I've 

had to come up with functional variations from functional specs, and the diagrams are 
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far superior to specs as far as finding the variations. 

Donna: I definitely like this method better than text — it's not that I dislike writing, I just 
think the diagrams are easier for someone to understand. 

Pete: I think this method is a large improvement over just plain text. With this method you 
can put in the text what you feel is necessary and usually, if you're showing a good 
deal of processing and logic in the diagrams, you find that the amount of text you need 
is cut down quite a bit. I think the diagrams are an excellent intermediate step between 
regular text and flowcharts. 

Terry: Another think became obvious when we gave design reviews with the diagrams. A 

programmer really had to understand what he was presenting because he couldn't hide 
anything from the reviewers with MO diagrams. The entire design is fully exposed and 
can be seen at a single glance. 

Tom: Any other comments on this point? 

Barbara: Yes. One of the big problems in OS is the fantastic complexity. I think the diagrams 

are a really good way to get an overall look at the system so that new function can be 

added in a much more logical way. 

Tom: I believe you said you did 18 diagrams, is that right, Pete? 

Pete: Yes . 

Tom: Can you give me a rough estimate of the amount of text your diagrams replace? 

Pete: Well, if I tried to provide the amount of documentation that I think my charts provide, 
I would have had to write probably about one hundred pages. I don't know if the com- 
parison can be made directly. If I was just writing text and had to sit down and write 
one hundred pages, I would probably tend to leave information out simply because it 
would be too tedious to write that much. 

Dave: I'd like to emphasize that point. Our job is to specify change to existing function in 

order to support a new hardware device. This could be expressed as a delta specification 
on top of a base design. Since no one has used method of operation diagrams before us, 
we've had to diagram the base system and then superimpose the delta on top of it. So 
we've spent a great deal of time documenting existing design in addition to specifying 
changes and additions. 

But part of the problem with the more conventional method of specification is that the 
designer doesn't do the job of defining his base. He just defines his delta and the 
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reviewer often has a great deal of difficulty putting the design into context. The 
method of operation diagram forces you to put the design into context. So to present the 
information that was on any one of our diagrams could require five or six pages of 
written text. 

Tom: Then have you any suggestions on how existing documentation requirements in the 

development cycle, for example logic specs or functional specs, could be modified to 
prevent redundancies or eliminate duplication of effort as a result of the diagrams? 

Terry: As I see it, the MO diagrams serve as a design tool from which functional specs can be 
written. I guess the MO diagrams can also serve as part of the logic specs and PLM 
documentation. I think what's happened in the past is that the initial designers have 
been drawing things that look a lot like MO diagrams, but they get thrown away some- 
where in the process. Usually different people write functional specs, logic specs and 
flowcharts. Then to complete the cycle the pubs people make MO diagrams out of 
logic specs and flowcharts to put in the PLM. I see no reason why we couldn't save 
the diagrams originally done by the designers. 

Dave: I see the diagrams as a central document in an overall revamping of the design specifica- 
tion phase of a project. We're using them to supplement pre-functional spec design 
work. I think the question of whether this is additional work is really not the issue. It 
may be the formalization of work that, if not going on today, should be going on. I 
think that diagramming is just a natural step that a good program designer goes through. 
But he usually has design diagrams on scraps of paper that he throws in the waste basket 
once the design is converted to prose. The diagrams merely standardize that initial 
phase of the project. 

Tom: Terry, you mentioned before that you used the diagrams in design review meeting. How 

did the reviewers react? 

Terry: I have heard reactions from several people. It's all been positive. They think the diagrams 
are a great improvement over the past. Programmers can clearly explain their work at 
reviews. I haven't heard any negative response. 

Dave: We presented the method of operation diagrams as projection foils. Since we had been 
using them for several weeks in our design, we just naturally started presenting the data 
this way without really preparing the audience for method of operation diagrams. We 
had the reviewers understanding the design immediately. The review meetings were 
very productive. Reviewers could see the whole thing in one picture, and we spent much 
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less time explaining what the design was and could spend more time analyzing it. The 
feedback was very positive. 

Tom: Aside from design reviews, what uses do you anticipate for the diagrams? What are 
your plans for them? 

Pete: We plan to use the MO diagrams to write final functional specifications from, and even- 
tually it looks like MO diagrams will lead to system plans and logic specifications. I 
guess the MO diagrams will be the basic input to the Pubs people. 

Tom: How about in the testing area, Barbara? 

Barbara: Well, in my specific area there will be other groups doing testing for different specific 

functions. It would help them to know what changes were made for our project, especially 
people that are responsible for maintaining the regression libraries, where our test cases 
will eventually end up. The diagrams will help in documenting the test cases. 

Dave: In the future I hope that the charts could form the nucleus of a base document for the 
whole system. As we go through the project and bring various people on board — for 
example, publications people, test case people, and new programmers — the diagrams 
will be a good tutorial to describe the project. 

Of course the diagrams will be used as implementation input. The people who produced 
the diagrams are not necessarily the ones who are going to do the coding, although they 
may do some of it. So the diagrams can help maintain the integrity of the design when it 
gets info the implementation phase. 

Tom: From a programmer's point of view, what were the toughest problems in picking up the 

diagramming technique? 

Donna: I didn't really find that many problems in picking up the technique. Every once in a 

while I would have trouble getting my ideas down concisely and trying to put them down 
in just four or five steps that would still get the idea across. But after I conquered my 
obsession with words, I managed to get the diagram down fairly accurately and concisely. 

Pete: The toughest problem I've had is that the logic I'm concerned with is quite a bit more 
complex than I can fit on one chart. I don't think that it's a problem with the charts, 
I think that I just haven't been able to break complex logic into more than one diagram. 
I tend to take a whole functional area and attempt to fit it into one diagram and some- 
times it gets to be too much. I think it's a matter of experience in deciding what can be 
broken down into subfunctions. 
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Terry: The big problem is that you really need these method of operation diagrams across the 
entire system. Also, we found out when Pete was doing his diagrams that when he 
started them at a low level and tried to build back up that it really couldn't be done 
with method of operation diagrams. You have to start at the top, at a high level, and 
then go down to the detailed level. 

Pete: Another problem with the charts has been with reproducing them for handouts. They're 
large and sort of cumbersome, and the size of the paper makes it difficult to reproduce. 
Reproducing is somewhat dangerous since the equipment tends to destroy your originals 
once-in-awhile. 

Tom: Any other problems? 

Sue: One of the biggest problems I had was making changes. We did the diagrams in pencil 

and we could erase, but after awhile some of the changes were just too much. The 
diagrams were fairly large and sometimes we had to draw them over. 

Tom: One of the problems, then, is updating. Assuming that an automated facility was avail- 

able to update your drawings so that you could red-pencil your changes in and give it 
to a coder-keypuncher, would you use such a facility? Would such a facility be useful 
in the development cycle? 

Sue: Yes, very useful. 

Pete: Such a facility would be very useful when changes are slowing down a little bit and are 
no longer major. At the beginning, perhaps, we would still stay with hand-drawn 
diagrams simply to have faster turnaround on them. If they had to be large charts, when 
we get to that level of detail, hopefully we'd go right away to an automated method. I 
think if base diagrams were available as Dave mentioned, automation wouldn't come into 
play until we were ready to make a permanent update to the base. We would mark up 
the base pictures to show our new design, and we would have reviews on that marked up 
base. As the design became firmer, then we would automate the changes. 

Tom: Did you find that the grid paper and template were helpful in laying out the diagrams? 

Sue: Yes, I thought the grid paper was very good as far as getting proportions and things like 

that, and the template too. I thought it was especially good for redrawing a diagram 

once I had it laid out. 
Donna: I found them very helpful and easy to use. I have trouble with straight lines and rounded 

corners, so I made good use of the template. 
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Pete: I agree. The template certainly was very good, and the grid paper too. 

Tom: OK. Let's go back for a minute and talk about base diagrams. Since they don't 

exist, how did you learn existing logic so that you could apply your change logic to 

it? And how much time did the learning take? 
Dave: In the initial month of the project practically all of our time was spent in learning. We 

read existing documentation, looked at some video tapes, and talked with the recognized 

experts in the area. 
Donna: I used mainly the Job Management PLM and I talked quite a bit with module owners and 

viewed video tapes. I think I've learned the most by discussing things with the module 

owners and talking to other people. I get more out of talking to them than I would 

trying to read the PLM. 
Pete: Yes, I certainly agree with that. But I want to bring out another point. It's OK to go 

back to people if they are still around, but quite often they have gone on to other 

projects. 

Tom: If base diagrams of OS were available, how would they have cut down on the design 

time, on the amount of design time you had to spend figuring out existing OS logic? 

Donna: I can only guess, but I think I could have spent maybe a half or a quarter of the time 
trying to figure out existing logic, and spent more time working on my design. 

Dave: I agree. I think we probably could have learned the material in half of the time. 

Pete: I think base diagrams would help a lot if the diagrams were done as I understand they 
are suppose to be done, that is, with sufficient levels of detail. There are certain 
levels that I'm looking for that just are not contained in the documentation that is 
presently available. I think at the different points in the design cycle different amounts 
of detail are necessary. For instance, at the beginning you don't have to go all the 
way down to the very detailed level. Base diagrams would allow us to get into our 
design faster. 

Tom: To sum up briefly, then, you feel that base diagrams, if they existed, would greatly cut 

down your learning time and would allow you to specify some of your design quickly as 
delta changes to base diagrams. But now that your diagrams are done, can you see ways 
in which these diagrams could fit into the existing phase plan or some similar system of 
checkpoints? 
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Terry: I think they should be in the design cycle very early for the people who actually do the 
initial design and planning. I think that a development group can pick up these MO 
diagrams almost at any point once the initial designers have laid out a function. Once 
the developers pick them up, they can continue to put the details in the MO diagrams. 
While this is happening, we can give them to people like development test, publications, 
and product test. We can let these people see early just what we're doing. 

As far as phase reviews and what level of diagrams would be useful at each checkpoint, 
I don't know. But it seems like much of the material could be available a lot earlier 
than has happened in the past. 

Tom: I see. Could the diagrams help define the point where design ends and implementation 

begins more readily than is currently possible? 

Barbara: I think they'd help. The reason that design carries on through implementation is you 

find out while you're implementing, and especially while you're testing, that there's a 
hole in the design. With diagrams it will be easy to see holes sooner so you can patch 
them during design. One reason you can catch more design holes, I feel, is that it's 
more productive to review say, 10 diagrams than to read 50 pages of specs. 

Terry: Another reason why some designs change during implementation is that the early planners 
write the functional specs, and then when the implementer gets them he replaces them 
with his own design because he really doesn't understand what the specifications say. 
I think this kind of communication problem could be alleviated with MO diagrams. 

Pete: Also, the method of operation diagrams are a good media for simply writing down the 
reasons why things have been done; a lot of my design reasoning is contained in there. 
So if a flaw is found during implementation, they would be able to decide on changes. 
You can't really pick up somebody else's design and implement it unless you completely 
understand it. 

Terry: I agree with that. The MO diagrams can be done in such a way that, by the time the 
implementer gets them, he doesn't really have much choice in what to do. I think this 
is good. This is different from what happens today. With MO diagrams the coder's 
interpretations should be identical to what the designer intended. 

Tom: After doing the diagrams, do you feel that it would now be easier for you to do a package 

for another project? 
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Sue: Yes, I think it would be a lot easier although it really wasn't extremely difficult in 

the first place. I think it would be a lot easier to get the feel of exactly how things 
should be laid out and what level of detail should be included — things like that. 

Donna: It probably would be easier because I have the basic knowledge of method of operation 
diagrams now. And I certainly hope that the next package that I get to work on we'll 
be using the method of operation diagrams. I've enjoyed working with them. 

Pete: I think it would be easier, but we need a little more experience in diagramming dif- 

ferent types of projects — more complicated logic, easier logic. 

Terry: It didn't really take that much time to learn how to do the diagrams. Once you get 

away from flowchart thinking or code thinking and get to thinking in terms of hierarchy, 
input, process and output, the diagrams are not difficult to do. 
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APPENDIX B 



A GROUP PLAN 

The following two charts are a group plan. These charts were prepared prior to preparing any 
of the individual diagram packages. 

Chart shows the package assignments. 

Chart 1 shows the major functional areas of concern, with emphasis on the interfaces between 
the areas. 
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APPENDIX C 



A HIPO PACKAGE 

The next nine diagrams* depict OAK impact to the Reader/Interpreter area. 

The first diagram (unnumbered) is a visual table of contents. It shows the structural relation- 
ships of the remainder of the diagrams. Included on this chart is a chart description for each of 
the charts, and a legend. 

The next diagram (Chart 1) shows, at a very general level, basic inputs, process, and results 
of Reader/Interpreter operation. 

Diagrams 2 and 6 show the two major areas of concern within the Reader/Interpreter. These 
diagrams are overviews, which lead, via vertical cross references, to lower level breakouts in 
each of the two areas. 

Charts 3-5 and 7, 8 are the low level charts in this particular package. Each of the low 
level charts is subdivided into five areas: 
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The consistency of treatment of this package makes the diagrams easy to understand; that is, 
the use of graphics aids the information to be conveyed — it does not hide it. 

Note in these diagrams that the programmers were working to an Operating System base, while 
interfacing with AMI functional specifications. Existing OS logic is presented in as much as is 
required to show the points of impact by OAK. 



* Prepared by Susan Montano. 
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APPENDIX D 

OTHER PROGRAMMER-GENERATED HIPO DIAGRAMS 

This Appendix contains four diagrams* from the Allocation package. 

The first diagram, Chart 0, is a visual table of contents. Note the similarity to the cor- 
responding contents diagram in Appendix C. 

The remaining three diagrams illustrate the adherence to the basic Input — Process — Output 
format . 

Note particularly on Charts 7 and 9 how the input structures were pictured without confusing 
them with the function being described. To do a similar job with a text description would take 
more pages, and the task of documenting these items in an understandable manner would be more 
difficult. 



Prepared by Pete Bowen 
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APPENDIX E 



WRITER-GENERATED DIAGRAMS 

The diagrams in this Appendix* are not affiliated with the same project as the diagrams in 
the other Appendixes. These diagrams represent a functional data Reduction package, prepared 
for inclusion in an existing PLM. 

No visual table of contents diagram is included. 

Diagram 27 is the overview, leading the way to the lower level diagrams. 

The remainder of the diagrams, which represent about 50K bytes of code, depict the dif- 
ferent data reduction functions, describe how the design points were implemented, and provide 
pointers into the listings. 

Particularly noteworthy are: 

• The grouping of the processes and sub-processes. For example. 

Diagram 29 — The "Scan-for-START-card process consists of three steps. Step 
3 is actually supported by many different routines, as shown through the cross- 
reference provided in the extended description area. 

• The simplicity of treatment of the major data areas. 

Only those fields that are used by the function are discussed. 
No displacements are included. 

• The Input — Process — Output format of each of the diagrams. 

• The overall consistency of handling. 



* Prepared by Gil Moore 
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foltouo>W> functions', , .. 

* (Wll +U, WMkr of characters I" *k. ^t-y na^c. if 
£P is specified . 



V^lUaj^ -to o- -nour- by+C hii^c^u r\uv^\k&c t 
tClAJt-cJk. &^d tot\\j<L<r+ '-five FiD co«l£.«'a..^d ^tf 



-tkft. V. IL&i^ A— <L T> < LPL-u<x(m.<l± 



(A£ce±i6/ 



1< 



KOt/T/KE LABEL FC 



^HEKKEy 



ISHVRUSC 



ISHDRHUK. 



ISMD^TMR 



iSHDgFtl? 






gMPBPtf 



EPPftDC 



AE 



M^ 



AP 



^P 



AP 



AP 
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29 start carp processing 



OUTPUT 



A B 



Ur— /■ 



i_y, 



i 



T>R" 



iK: 



> 



a BAX>F(i5-! turn^i oia /f ■ Cot^ol Carci . 

iKd po^t" »S fo^^O , 

B.STACPUy; turned on uJl^e^ Sfart/ng 

point is /oca>e-d, 
CDCTMSG-'. points to out/xJf buif-ftr- 

DiDKT6uF •' points +o fast i^pot" 







^ ft£.fu™ -to ISHDR. 
PESCfc I PT/OTO 



RW/TJI^. LAgJcL FC 



nnp« 



Xt +^e user has coded ^S olw ^ ^ecord ana/yzer routine., it is 
r lonLd^d a^d called by ISMPR&E&-. Of*^crw«sd , o^e. or r^ore. of tlje. 
■hKe. Po/lotoI^Q co<jv(,^arfc+iue. -fech^uei a^e used +o position -fke. 
input dov+cv -ttt; 

• /Iia iVu'ticJiied cooMtr CRecCOuioT) is i^cr£jwe(Ated by o«e_ 
^ack. -ti^vt- o^ record is r€Oji. u^^^iA +k<L. CjOouvktr- 
reacke* t-kt- li'/v»\+* M^rtcord ^ea.d|/\g haj+s. 

#tup ron\/cr-fe^ Fit? code- 4s com^oarcd to eAckneto/a''jXD.u;io l eiK 
ty^^+£»ZW J «i ^^-(dHki ^ ^-t- specified t^ 






eAfe_CoT€-, 



ZJZ ^ e t^rii fivvxel <jf iMp , Minos +U. ti^ue cm tk. 









^1+ recordTj /& co^par^d -ho -t^e co^^er-fed T- 
1/cxUA.e. * COUe-n a. rztord u roo^d tottk. A- •tlrv^e i .-| , ^^- 

ha.l+5, ^ 7 ^ 

Vm^ -f^T>er -?s ^r^d ov^, pex4uF P o.^4o 

?k«. coddre^s of -Hi«- record to fc*- proce^e_a fiof-. 



»SM0R6£& 



EPpROc 



MCGMP 



KOMP 



TTOMP 



STCTFOND^ 



0F 



AF 



A6- 



^F 



rlF 



rem COMFl~D€NT!f}L 






Kpor 



-DfcT 



mmpt^mf^mmm 



E^tdK^l Apo*^ 



■ > i i 







KEWAL 



Count 



kEloG-TH- 







TVPg. 



"NAME. 



**1 



PROCESSORS 



FORtfSf* CARD SCANNER 



\ CkedC nuM4>ei- of fceywxxds 
£ Ckecb (e^-Hv of Ta.b/<L v\a\M^, 



zj> 3 £^<^ Jteyuoord -hype..* 



8ASETABLE. tOADER 




ZLloond user-bu</+ base, fable. 
C place, <xdd'es3 of feble In 

^ -drt: 



£ tadica.-te. user's frLbk h 
-fo fcx. u^< 



U5C 

?d, 



ft 







OUTPUT 




PRT 




USE.R 6ASETABLE. 



A. FC£MFL6 ', iumed on a-Pfer 
user's hase-taio/e. is /oaded 

5 , BADFL& : fumed oia if ca/-d 

Contains errors. 

C D£TMS<r,' fWb fo OO^pjf 
buffer- for error r^essa^es. 

Q, DUTAfb ! POi^b +0 frsf- 
e^fru 'i« user's basetato!^, 

PElWTEP 60TPUT 






1 


•PESCHIPTION 


RouTiue 


LA££l 


PC- 


IK 


The. EKJTCwr field in +W« W.T it, examined, If if 

error rwcsso^qe- isJpn^fed <a*-\ci da-fa_ rcaocfioi 
/5 skipped f6r the Set" of Co^+nal C<arcb. 


/SMDR 


FORMOPr 


t\h 


2 


V4LEJ0&fhe. keyword lenafk i*dica.-for is 
tested . X-r -4-tie. keyi^d -Field contains rvicre. 

irp.'o+tia^ ded-a- r'e duct/on is sk«p,Jcd.. 








3 


The K6YVOD -field, ■-} GMSMTA6 is exai^'i^ed 
oua6 i'f it does not £o^+aio +Ue , oocd, 

dexfa reduction (S. sk/p^cd . 











DESCRIPTION 


Roun^e. 


M6£L 


fc 


4 


ISMPkL Moves tfoe, not-we of th*- user-builf- 
bcJ^cfc-b/e. tu "TAftKiAMB. 6.^-d issued <x_ 
LOAP to bcwQ <c- Copy^ of t^e. i<xk>\^. ffow\ 
5ysi,L|M*a_iS ir ' ,a - library defined fcy 
fkc- uier Ola a- STEPuS c^^d . 


I^MDje. 


PORMOPT 


«© 










5 


After- -Hve t<s.b/e /'s loaded, -fine address, re- 
+u/iA£d. i^ rc<=ji.5.fe.r (6 K saued i"v ~^i^~&- 
"DrLTTAii f-G (A of +k^ T>£T, 








6 


The FORMFLG- field l^t tk.<^ "D*iT (S Turned 
O^v io itAd'C^fc +U<x+ riie, Uier'5 base - 








: 


£Zh\c ('Or OiC , 









30 fORmrcmv /im/ilvsis 



-^S^ (!^v^ 






ik^-* 



iMpur 



c n?o£^SW' 







VALHJ 




i-O 



6A3ETA8 






tfREF 



t 0# 



*f <p ft 






* 0<£ 






t^> 



PROCESSOR 



PROCESS CARD SCANNED 



luPAEMPTg 



D c+er^i^c keyword "fype. 
/ Service- re<=\oe.<>-f~s 
( for- pa/envcfer field ^-' 

/)m rtcord I. TVs fc> ^c referenced 
c/uri^Q da.4tx. reducf ion ? 



fck 



KEYWOSD 
COMVStfEfc 



VSEi^PAftH 



FlD,\/,l?EL 



N, NIC 



£P,"DDWA/1 



> 'n» 7 r 



NO 



YES 



BAS£1$BJaE SETUP 



-v' 



4. Locale and 1'de^-frfy eiA^y £ Ovtrnd^ £Je.{W|4- 



Place ajdeinsis of e/Hr<-? 
i*\ XREP +*.b/e. . 



7Ctau"\ address ei/Wvy 
-ft? o+Uw £tf"hnes 
UJi+k ft\C SAkAAJL. FID, 



ALL entry mi£9srr up 



-4© be used • " , *^•^ 



Fill in /U1TA6 block. , 



F,!( t'n tfR££ -fable 



Service., request *> ^ Qr7 « 
records , 



1p f?eWn /d £1MD& a^d 



NOTE: *K£P i's 2?<b fuilooords 
tuifU. (3- fu(/too^d sloi- tbr 4Uji_ 
a-ddrcss of e.ojLU tK+r-ti \n 6»AS£- 
TA©. R*fero.ccd fay P'D -codas 

slo-H is. iVi'i-ZtccIi-ia^. -te ^e^oci. 
ay\d is filled «'o fia'cA -f iVtve. XSM - 
H>£P(lo Ipca^es a. ;faa4«.+c.<o(8_ evrfru 
•fo toe. uied cUm-iVaa djcjA- r^axvcn^*i , 



| mmvmmmmtmm ^, Bna^oU. "to +ex+- 






a— 



31 PROCESS CA£D M/UYS/S 



OUTPUT 



-DR-r 
a a c 



JJJu I 



^ 



UE&ElOQ 

_iJof used dori'-vfi Process - 
_ Us^d bof i^of a-l+c*-cd 

- Fiu-ed i'^ doz-i-a P&- 
££ii-Ci^trd Ct^C^'S 



A. ^ROCFLfr- 4ur-«ed on 4o i^dicotfe 1SMDRPRO has fcec^ c^l/ed . 
6. 8At>PL6-"K>*"^ed o^ lAj^ie^ errors <xre defected o»n 

pROCf. SS - Card , 

C ' pUMPPLG - ~ -Kir^ei on +o dump records uj/f-^. on — 

D. PgTMSG - - poM-fs ^O Oo-f/30-^ buffer- fer error >vieS3«xj£S, 

TVPfCAt, B/45HTA6 ENTOY 

FID .OONFID SAHPTyPE SAMPeATt SAMPCUTR EPWAHE IWAMt PAWJAD CH^MD 




I 



4 



■yp£ SAMRZATt SAMPCUTR EPWAHE DWAUt PAKHAD CH 

hi liA-i / i / iT'l 

> ' ' a a • • 



DepiTG-s 
DRPL&S CI 6Vrt"> 

SjT LA6EL FUWCTIONJ 

"^*- L/tSTE^T"/ on a 'a-^t e^+tr^ in rcJolc 

3- CTRSTAT/ — -•'" M °~ °" 

4- COHOPRjDC 

5-- MODr'LG-i Ok ( - -»...-j > ■ -— -- - - r 

^- KJTPi-G- 1 ov\ — 60kv\pi'Ka da+<\. i"\ AlltaQ -&o be. uiedi 
-r_ NHFUfi-i Ow — CiA+ry Ailed, by doi"\rt a»a EP«0^MC- 



ir/ on 3 la-vr e<A+»-ey in TA-fe/c 

,f; cm= Sa^phAa too^+er- enaloled , 

IPC ' 0(|\= coiAdifronal F<D process^ ^ues^cd 

■: ons «K4ru ka& bee*% ^edified o-Trcje^dy 



>\LLTAB ENTRY 



^ 



pMi-i DDNM AP/!l?M A$W A5MC A. 



MM 



AE-PMli 



APAm AiM^ A5MC ASMr AVLG-S 



Afl&s C± eyre) 

6lf LAteL. 



FokjctiqnJ 

<?« - allplg- : cm=^I records wi+lo a. ree©^izai>U. F/D -fe 

jo Mu»-f-uw- processed . by ory£ MractfAfaa x roonnc 

a - Aomy : oh- -o*\lv Pe.oce.ii c/xVd-iA^'xrP <* t-k«. cue, 

X U5liAq ALUTA'B 1 r.c • 

J _, I 

5- ACTSTAT ' On=-Saw\p/^ counter <Tasmc^ ewa.blcd . 

ah - PeocesS-rCavd 6on+ajns PID-/RLL opfi'o^ 
3 - /4LLSW ; ° ' " 

-Pkt_ oxe^ of ALLT/ie . 



^f/^ C0Mf/I>^A/r/^L 



3| PROCESS C/I&D /)W/?LY^ CcoMf.) 



DOCfclPTfOK) 



ROUTtuE. L/\6E L FC 



2 



3 



U/h€.^\ X5MD£PK0 receiues Cou+r©^ i+ iiifi-a/iVe-S a/I pointers, courtfers^nd 
Stuitthei +o be u.ied durwg P($c?celS-coircl dialysis .The KEywD field in 

PfcO is flipped u>ke.ne\/er a.\)a.Ud ^e^ord +ype is encounter- e-d , 
# XP +^«- ose*- tv>i specified -Hmj. PARW op+ipn a <t£TM.«WM /s 
issued "for co^ ST0ro.ee* "T^ address of +&a^ airea. is placed 
i"\ VPARhPTfc. A^d <x[[ oarO fw.ftr- i«a fo/^v^-fio*^ 'S f^c^sf erred. 
f>o/^ +Kju ML. field +0 U$£lZPA£M> 

ISKDRP£0 issues ft; LfMK-fo v/a(Mc-c^cL /com; er^'on rootWs toUcA 

p£rfi?rrv-| "t^ poHcxoi^Q functions '. 

EP or T>"Dkjam£^ op+ib^J &^c u;td , 
# Ckfl.ck, cu^d coKO£r4" -eo^ejl dccin^cj vAxCut. of- tJ en. Kjfc f 

Xf fU*, user tan specified FlD^ Code. .Ccade.3 > ISMZ>£PR0 executes f^e. 
Kic,fruc-j-io\s ujUacU, (oca>e. lO^d ►wodi'fy B/As£T/\6 eiAf/ i-e 4(4-7). 
Fb»- Fio=Aa$o/DOMR3 lSKDepfi.0 for^s o^\ /flaSoO a^d «xtcu.fes (+$ 
A iu#6 sef-op initruc+ic^s ^8 - 1 z.) . 

8-ASETA8L£ SETUP 
BASZTA& is «WtU-<ui fo^ <x FlD code- or EPna^c -ho v^cJtcl^ 
+U.ono \occ^suL i^ 4-k«_ V/4L fre/d of KEV\JAL, Ia]Uc^ one is 

-fk<>. *^ fs -to be dted «,*d can/iof be. alizr^d. by a<-w cfhtr- 
pRoceiS-cajd in -f^a. Se^, (kjotG '. xf EP ^d Fife aphe*r 



tSMDftffcD 



ISrtDfcPiO 



KHDRUSC 



^SMDRWWK 



EMP^THR. 



ISMPRP^O 



4>\ 



-f-hd. card ^ +lr\£. F\T>-COd t e. i& uStd O-S CLSea/CK. O-rbyn-i^v.-f* 
^a-vnri njUem <>»- yv\<x+o£\. i^ fbo*-id >^ S^SfeT/^fi -+Kjl. j £P'«ia ,a^^_ 

is pl(x«_d m t'x- ^Pk>^me fie-(d.> 

TKe «- lftor-ifh/v\ 'currenf FiD cede +1' is used as Ct^ l^<^&X 
l«n+c +«>- XR&F -^o-blc ■ Xf +Ujl. f ulltoor-d s/o-f # cc?(A+a.'i^S 
£Croes , -J-^ c-ddre.s*> of +Ke. B/1SeTi^6 e/>+<"y. ''s Moved 
-fUere , C+kjjrcul'se. ■ +U+. o,ddr£SS »s p/<Xce.d''*v -H-c CHA/MD 

field of -fl^ju' /^s+- e^+^y '^ fcASetfttb h> bt crta-ivl lo*+1^ 
-f-Kt- S<^t^<- FID code , CSec 7 "> . 

k TK«. Mi'+i'cu! UA/utS of 94MPTYP£>S4MP£/\te. j <:0Mf:|P ) PAHMAV 
aiAd T>X>iO/\Me fi'cldi Arc pverr/ddcii ^s re^oeif^J. If f^e. 
O^er ^cis Spec'ifitd cc +n^uit- or reco*rd coo^f" s&imp/'~<s 
fecUtAicue j +Ufi, CT/LiTAT* f(<*c. iM "DRFL6-5 IS torritd oV^ 
io i^sdicoL+t. t^a-Sa.vwpli^fl coo^+er SAMPcioTK- is+Obc 
US^d du^i^ci d<x-foL. reJduC-Tio*^ » 60^e,n fUi_ co^d l+jo-v^f 
FID op<*to*r *S Uicd. , H-Ina. COM"PP^OC f Icl^ is ■/■jr*«xl. on. 



5TRT5CH- 



PMP^jDO 



FrO-E-RdH- 



TABSRCH- 



EK/THEeE- 



BLDfe/^sE. 



EWTHE^a 



?MPR0C 



DDNOK. 



/\rt- 



M 



AP 



/IP 



AP 



PlP 



A* 



AT. 



hi 



A J 



A* 



Al 



AT 



DESCHlPT/OM 



K0uT/M£ l/^/6£L FC 



Uhene\/e.r a. cowlrol tafd K&.& c^ PiD code. tvva+cU^^q +tva_ 
PlD of olia £v\ + <w ujUxck ^S becvi o.(te«-C(i a [rtc^d^iy 13 HDRPftO 
creo-iei <x rveuj 'e^+ l -^ ^ -M^- i(x\i-e^xi of BASETAB <xi^d 
no>^H thi.. ch AikAt; Jfi'eld of ^^e oM e<A-f^^ to tUjt o-ddresi 
of t-^c tAewj, Tka. CHAiNi/^D fi'e.ld of +Kt. k/lo e^t/-y )s 
zeroed ou+ ro,Md icc\fc +Wai if »'s fke las-f entr/, be,- 
Io^qi'.-q fo +^'s FiD class. 



'V 



/4LL Eior^Y T^6t£ ^er up 
T^e M0DFL& frtld io every b&ufo^l^ €u v f^^ /s fo^€ d 

5<a_i/N-\p/iV\o irt fc>/ ^ c^.+ io^ . \JJFLG- K a./so fo^n^d on. 



9^1X46 poi^f^ -f-o -H^g. address of -ff^c rVsr eM** \v\ 

r^ov/ed -fo +JAe " coir/.opo^di-^ "Fit> s»lor ' iv^. _ 
xr.^f-, BPTR /'s Mce^c^fed .-+o +!*+. i^acf hayL-fchl-t. 

(S -filre^d « *T^»-S p>/ocess fo«f(KUti uuvfi I +^e^ 
cxddiresi oT eut ( ' 
placed i^ XZ&F- 



ismtpfro 



w e^+/ l* \^ QAie-iAfy K^^ /bei?i^ 



■, TWe. E.P \na\A\c is coped f/-ou<^. -{Ue. \jAL fie.\d i* kEVUAt— 
+o -fU€- /IEFNM f*€ld of/)LLlH6, OtU&r- fie/di M flUSmfo 

art- c^i^cd default yaU-e^ exf f^is -bVv^e • T/^^_ 
/^LLFLcr 'bi-H is turned on_ o^ffet- -i^jj. /iE-PMM fte.(d k<^4 
bee^ Se+. T^a AuseV f/^g is a /so fu^^ed o^, if r^or-c 
+l/vo.^ oh coko+^ol a*~r~d in -fKfl- set reauires -fk-a~ USC 
of /iLLT^ft , -r£-*_ /AuSET> f/^<j root<.i -M^c r6.C|ue-sf- 
fc fU*, enrpr- p/*^t"0uT, roufi*^. a^d fur+ktr— p^o- 
deVit^A of f)h-r ic>+* /s. fer-KVM^c^Te-d , 

OefauH- vcituti ofDPwH^P/ftM /SMft. a^d t ASHT 
CLrz. oucvriddu^ £H ree,u?sfQ.d« Xf t,U<u ^icr- specifier a. 
sa«^pli«^(3 rixte , -f-i^-. /icrST^T k>«"^ (S -fo^^«_d o^» 4o 



1 



^p /»^ ft 



WUe^ ISMDI2- ^ceiu^s co^vfz-ol ^ if O^^i^ ft-c_ 
/IlcFLG- lo.'r*. rf f-U^i te*4 /? o^. XSMPe (cx.ds+^- 
ose«--speci'ft^ci procet>5»i^ ., rou4<^_. 



IbMDft 



NewENJT 



SETKoP 



BLPkREF 



TSTAUSED 



DX)M0< 



PMPftOC 



CKAWBV 



&LVALL 



CLRXREF- AA- 



AT- 



fil± 



fitt 



AK 



AT 



Al 



AK. 



AC 



~Z8V\ C0/oFO>e/uT/A^- 






BOTtNT 



APt^ESS 




imcm SCAMME^ 




VADfc 



TYPE- 



WUBJ5-V1 >#LPLt> 



keyword 

VALUE 



C> 



J. CKeck. -for ewesyve. fayuWs. 



pCCiG UsJLW" f I €-■ Id 



COMMOWOT^OMS SET-UP 



GONUBECg 



FP 



no 



^ In* 



•b->L 




', Place coiner ft.d iceuujo/'J u& - 



Ot/TPo' 



ENtHfcjwr DETECTtOKj 9ET-UP 






•f;C'.^T*a\;.V 



"'«. 



USERP^EM 



IOV 



4 Identify opt i 

5 Select rrv.^-M poi~.f- f© +/ 
a,f/ op/ icd^ J c^d-dz H c tor 






i; see mod 


r ^M/U> 


KJ0M61//IL.U 


ri^'v "■'•■iL 


7/M6W/L.U 


V l/Ai-UE. 


! - vl 


7////////// 




Kim:* 


0PfD 


iHlSPib 



STEMDC 6 



RxtJreRi Poihtere, 



DeiCfclPTlONj 







fe>l. U)he*u I9Mt^KiD r«£wes couirol, H~i.ssuei «- L\^L to ISMD£££Cf • XSMD£e££r exa»v\mfi~s -tfie ENTC(Or 
1^^ ^cld, i*\»+kcP<LT #*\d if i+ coy^o-"^s cx~v<lIo<l areocKr -ftvo.*- four, ^-c^. error tMCis^c. K 
orWed aw^i aoJ*^ trcd^c+ioi-. »S stipped for 4fk€- &*l+ of Ok.rtis> co^Hlh^im -H^t error. 

Z.TUe. KeywD ffeJd m£n£WTAB ;s ex^uvuWd* i-Oke^ a.va(<cL keuword- /s ciACfcurfered) cl UWfc is issued fo 
ua(oe,-cU£clc/£C>tA.OC'"SiC>k\ roo-Hv'i ££.£$£-«. diaya^ 2.CO. Xf <x*\ EOD- card coiA--t&iv\S ftiAinuaud 
te-WuJOrd \;O.U-02.> 6.0^0-. reAocHon. is. Skjpped "for "+^-<- 5 - <2 -+" c^d. *-i\ error ia<\<LSsaae^ K prm-fe^, 
Xf fU«. PARH-optfOi^ is. cpecif«€d ; a_ GETM^/Ni is issued +0 tfccjuK*. sfo^a-cje- fcv J -rU- tier's 
p<x^oi*~£-T€.r (i<vr. 

fields s-'e. f'l'^d, a -* jre^uiwed. 

T.MEUALU is se+ +0 +t^ U^ksc of +^ GMue^ud +1^. j* tcocj c_^<L F l *5>TT JME. ^ +k^ 
. TH1SF.D, V^ ; ^M^S^ *wn>iSPL a,c f /»edi- ^ f^«- ^-^ ^hf^ **. ^lW. 

/jrftr c^ mii<il J ' /, py>/jLiT£^/L tr -H-t- leuiup/H ivp<_ »s c- co«^G/>«xcrto*>. of option, HD/AJT6K..Z. 
ad£2ii of «5^- u-viM;cnW tAfWCcA. icf^ <^ »rcfou^ Co <L. u^l^^v- fu^ e^d pcx^cf is /ic^cCout, 



flXmKlE. LA^EL FC 



isMT>ee^<sr 



XSMW^EWD 



EPPiRft: 



WPROC 



TfifcOc 



FI0Pg^,A6r 



AE 



AP 



/IP 



fa 



AL 




a e 



-y se ere st, Nte iT. Pteh; 



/V 



o^<i ' poi^+e-vri it? €^a-dft-— 

-/e c-h?^i CCUflL U«- *<;*+ ■Op'. 

o,^v er»*«ri 



32 £M1^ CAR.t> P^OcXssiN)(S-. 



JZB^ 








"DATA- re,t>octioni P^ocessiios- 



(9UTPc;r 



RECORD SELECTOR 



1£-£+ procesSAa J^fo 



\Ccfion rrofn 



set" ft? requested record . 



ENP-PQ1MT DETECTOR 



r 



RECORD CO>A«fcrE*./PRlNTEfc. 



&'<z^H 








3 Call procciii^a : rouh'rt4_ (a) -_ 

4Co*werf record jo ffn<\J*hl4- 

5 PnV»f" record 



Q Cft.M e^d-tife-fecfw roofi^e. 



fCkjL<iK (or- tv\d a-f da-Jo*. 
re,doc+io^ . 



PbSMATTtD -/ 
- ClM OUTPUT " 



^:'D 




,PATA KEDUCTIOM TE^WAT^ 



M Release ei/\d-<fefecfor- 
w a^d prtJctisW^ *w*iuUs. 



Check for- *v\ore Control 
Cards, 



Cf'Oie. daJxK. $&ts 



"DesceiPTiON 




eO(JTlM£ LA6£c PC- 



^ tZ|M' ti/afioJZizo-i 



3 J I 




fBM( 



tlSMPClu? ^J&Myeut t , cKceHft iSMPg rff 



mmF 



A INPUT TO FOWlTifJS &X)TII0ES C iKflVT TO XihVeHBK 



A&fci 



TiMetuwrrs 



*"> 



Me4 -M 



ajrpi/r earat 



E>. IKJPUTTO lSM1)a.T«H 



BS&i 



=\ 



BYttCouuT 



HE* VAlufc. 




■OUTPUT flfi£A 




TJSMDfe. -tKcUWi^s +t^- ftOJPLGr £ujif£^ ia^. /kcTTte «If <f '* o\> «cord I.H's 
JU~C tq^ot-ed aYs^L ; ^SaiMp/(^ typjSj 'in^rrnK-t-'i^s^JS eJcf^cW-d tro*^^ +U<l- 
,A>MT fidld. 0+t^woivc. ; XREF ii C<.a.vc(^d o«Atxl ISKP/^. locates G.sf©f 
cfoK+txtVv'i-G 4-l-«- cvddrtjs of a. "BAS.£T^8 e^f*-u uJi^-bi«- FiD i n\Cvi-c ^-«-3- 
^U.fW'tt--. irtc£>J-5i pointed fo u-h ^KffeuF. S^^^^f"*"" 

Xf o^ oaco^ is k> t<. p^i^+ed /xe<a<x 1 ^d<e4i of «fs F'P, 3SM"Dr^ Auecds 

ov^m f^s- fi^.f uc^Uou As*MR »'s r-toctUod ©rtrceecfed. If ^<W 
f€,'e.c,+w?»^. <*cp«wl.i .<M.fUu_ Fl*D, ISKDrfS. ^o^Kols f^A. i*x>u^ 0-Ov of 
reo-d Opfcro r + , tof\.S i/icc +^«- SAMPfe/HTE. A^d SAHPCMTft., -Pie- Ids i^ BASET/16, 
for rUifti USl-^i +i^c ccx-vdi+uo^*-/ F'TO optvoi^ . 1SMT>^ ^(so Upde^^^S 

4-U_ FipSE^? HFi'dd. «xf f<^- totiw r-c«Ld op^r*v.fU>'^ u<AfH +^«. ucct^c 

** X^ AtcPcG- <s o<^ i XSMPii, pa^sjti Co^v4/ol "*t> f^. i^-ocU^U^ 

* coU.'ok. If /oc<ki fi-fftr- PfcOCE-45 c<t^d fi^c^iti CSe«. cka.^/t*H 

. O+U-ujtlc, +^*- STATUS fk«K "&/?* E t£j§ ,'> € ^^''t^^ ^y^-i*^/- 



a:$MT)R 



TA6S&H AC 



SWfiOR /)£. 



OtiLiALL 



TA8UJ0P 



GETW 



TSTWWE 



AC 



4C 



AC 



ftc 



•PKCRiPTJOn) 



4 



I5HDCXX 



£»AO«rtC 



6 



8 



(AJWtw ^v. prcxeiSiA^-, ro^-h"\t. r-eceiu«i CotA+ro/^ ('+■ S<-+^ t^p ©^' pa>ay^-fe r 
|i«s+- irttU^ii«<& -DtM4+tri fjj. -^U^ de*.fot- -ft) ^c OCKUC-kd A^d +© TK«_ 
Oo+out- Pc '© ■ t A ? . Coi^-fro ( 13 fK,e<^ p<^SIcd. +0 r S/v-vD«LT»M <V^<L- 
JS»M"Dfc.H£x. Tt>' f>eS-+or*~*. +U^ follotoi'^q Unctions; , , i- 

,^Ks <*. r IS- (*-»•)+«. £-f3>a>!C fo/i^-c-t- (6) » ' . , 

leMop poi^ttr* tJf^~ V^rut torft'r- a^d t^ DcHp^f T>C8. TK«.^. > 
rSMPfelKJT uj'n-fes Oof fKt, <ionveirfed d<X+<x. . 

I CL^cL -ftsA. t^.ptcd +i^ ^T^Vr? 



U«L FC 



ISkTOl^ 



rs.Mi?(2.'d 1 e../^es 



9S 



p' 



4 up k^di-^J for-fi^ K«.VLf /u^*. a^d pcxiiei Co^+/ol+r> '^ COjra 



vt r ' 



OX3UT- 






»Q wUtet fej YCT^C&^ CX^ Closed ■ Cb^tol to na^urv^d +n ^^ J^, + I «.(»^L 



BHWJEJJD 



TMPR. 



AG 



USE2TEST 



■fTfcST- 



-Nrevr. 



TTEST 



E>JDgO*J 



cowr 



USfatt 






A<5? 



Ad 



tlr 



33. P£RFOfcM|iO<9- ACTML D/^TA- -ReD0CT(OM 



^V^ MF/be/JT/tfi 



